home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
BBS Toolkit
/
BBS Toolkit.iso
/
programs
/
dizman12.zip
/
DIZMAN.DOC
< prev
next >
Wrap
Text File
|
1993-05-31
|
29KB
|
604 lines
╔═════════════════════════════════════════════════════════════════════════════╗
║ ┌────────── ┌───── ┌────────── ┌──── ┌──── ┌────────── ┌──── ┌─── ║
║ ┌─── ┌─── ┌─── ┌─── ┌───── ┌───── ┌─── ┌─── ┌───── ┌─── ║
║ ┌─── ┌─── ┌─── ┌─── ┌─── ┌── ┌─── ┌─── ┌─── ┌───┌── ┌─── ║
║ ┌─── ┌─── ┌─── ┌─── ┌─── ┌ ┌─── ┌──────────── ┌─── ┌── ┌─── ║
║ ┌─── ┌─── ┌─── ┌─── ┌─── ┌─── ┌─── ┌─── ┌─── ┌──┌─── ║
║ ┌─── ┌─── ┌─── ┌─── ┌─── ┌─── ┌─── ┌─── ┌─── ┌───── ║
║ ┌─── ┌─── ┌─── ┌─── ┌─── ┌─── ┌─── ┌─── ┌─── ┌──── ║
║ ┌────────── ┌───── ┌────────── ┌─── ┌─── ┌─── ┌─── ┌─── ┌─── ║
╚═════════════════════════════════════════════════════════════════════════════╝
Documentation for DizMan v1.20, written 1993 by Stefan Kuhn.
╔═════════════════════════════════════════════════════════════════════════════╗
║ Short overview about DizMan ║
╚═════════════════════════════════════════════════════════════════════════════╝
- DizMan writes the description found in the original FILE_ID.DIZ,
which becomes more and more part of any files in BBS, into your
FILES.BBS!
- DizMan can also write the resolution of several grafx formats to
your FILES.BBS!
- DizMan also works on several sound-formats. It writes their
internal songname to your FILES.BBS!
╔═════════════════════════════════════════════════════════════════════════════╗
║ Why DizMan? ║
╚═════════════════════════════════════════════════════════════════════════════╝
- DizMan's great advantage is that you always have access to the
original file-description FILE_ID.DIZ and therefore is no need
to accept any other description given later! The author's desc
is the best desc!
- DizMan prevents your system from giving your users file-descrip-
tions like 'a very nice MOD' or 'a new utility'.
- DizMan should work with almost every bbs system that uses a
FILES.BBS list.
- DizMan is high-configurable! You can add new archivers, new
grafx- & sound-formats etc.
- DizMan comes with a sample configuration, which works on ARC/
ARJ/DWC/HA/HAP/HPK/HYP/LZH/PAK/SQZ/ZIP/ZOO archives, selfextrac-
ting ARJ/LZH/PAK/ZIP archives, the BMP/GIF/JPG/LBM/MAC/MSP/PCX/
PIC/RLE/SCX grafx formats and the JMS/MOD/NST/S3M/SD4/STM/STS/
669 (also FastTracker's 6 and 8 channel format) sound formats.
╔═════════════════════════════════════════════════════════════════════════════╗
║ Note... :-) ║
╚═════════════════════════════════════════════════════════════════════════════╝
I am reliable for NOTHING that happens to your system!
You are not allowed to use DizMan in an commercial
environment. Any site with 4 or more lines, which
charges money for the actual access to the BBS or
which is located in a commercial environment is
considered commercial.
╔═════════════════════════════════════════════════════════════════════════════╗
║ REGISTRATION ║
╚═════════════════════════════════════════════════════════════════════════════╝
DizMan is not a Public Domain program and is not free! It's ShareWare!
Non-registered users of this program are granted a limited 30-days license to
DizMan to evaluate the programs suitability for their requirements. Any usage
of DizMan beyond the evaluation time period requires registration! Use of
non-registered copies of DizMan beyond the original evaluation period is
prohibited.
Registration Fee:
Non-commercial users in Germany DM 10,-
Commercial users in Germany DM 20,-
Other non-commercial users US$ 10,-
Other commercial user's US$ 20,-
Note: You have to poll the key from my system! If you are not able to poll
the key you have to pay DM 5,- (US$ 5,-) more and I will send you the
key including the latest Version of DizMan.
To register DizMan please transfer the money to
Stefan Kuhn
Volksbank Passau-Freyung eG (Germany)
BLZ : 740 900 00
Account: 4771 6
Please write your full name, home address, BBS name, FidoNet Address
and the program name in the notes for the receiver at the transfer
form.
Or send the money in an envelope to :
Stefan Kuhn Stefan Kuhn
Stallerweg 12 Stallerweg 12
8390 Passau-Rittsteig 94036 Passau-Rittsteig
Germany Germany
(use this after 1.7.93)
For further information you can contact me via NM:
Stefan Kuhn
2:246/222.0@FidoNet
9:494/6000.0@VIRNET
22:32/9.0@RockyNet
23:100/21.0@KultNet
94:510/301.0@CDN
After receiving your registration number insert your personal registration
number in the DIZMAN.CFG (see RegCode).
If I write a new version of DizMan, (I suppose I will do so) you do NOT need
to reregister your current version.
The registration number will keep all further versions of DizMan running.
Please write your registration information down on a piece of paper and store
it in a safe place to avoid trouble.
╔═════════════════════════════════════════════════════════════════════════════╗
║ Selling DizMan ║
╚═════════════════════════════════════════════════════════════════════════════╝
1. I do NOT allow the selling of DizMan via PD/Shareware marketing companies.
If you want to, you need my written permission.
2. I do not mind if you put the software in your BBS to let other users make
a download of it.
3. You can also put the software in Shareware-packets (e.g. Mailbox-software)
without my explicit permission. However you are not allowed to put it in,
if you sell the packets via a PD/Shareware marketing company. (see #1)
The things I mentioned in #2 and #3 are only important if we talk about
the complete archive containing the following files :
DIZMAN.EXE The executable program.
DIZMAN.DIR An example of a DirList-file.
DIZMAN.DOC The english document file. (This file)
DIZMAN.DOK The german document file.
DIZMAN.CFG An example of a configuration-file.
FILE_ID.DIZ The short description of DizMan.
FILE_ID.DOC A short description of the FILE_ID.DIZ format.
╔═════════════════════════════════════════════════════════════════════════════╗
║ How to configure DizMan? ║
╚═════════════════════════════════════════════════════════════════════════════╝
Create a text config file (best use DIZMAN.CFG)... >8)
DizMan understands the following keywords:
┌─────────────────────────────────────────────────────────────────────────────┐
│ Register │
└─────────────────────────────────────────────────────────────────────────────┘
Starts a REGISTER frame to define your name and regcode.
┌─────────────────────────────────────────────────────────────────────────────┐
│ RegName <string> │
└─────────────────────────────────────────────────────────────────────────────┘
Defines the name DizMan is registered to.
┌─────────────────────────────────────────────────────────────────────────────┐
│ BbsName <string> │
└─────────────────────────────────────────────────────────────────────────────┘
Defines the bbs DizMan is registered to.
┌─────────────────────────────────────────────────────────────────────────────┐
│ RegCode <string> │
└─────────────────────────────────────────────────────────────────────────────┘
Defines the registration code.
┌─────────────────────────────────────────────────────────────────────────────┐
│ End Register │
└─────────────────────────────────────────────────────────────────────────────┘
Closes a REGISTER frame.
┌─────────────────────────────────────────────────────────────────────────────┐
│ Settings │
└─────────────────────────────────────────────────────────────────────────────┘
Starts a SETTINGS frame to define the default settings.
┌─────────────────────────────────────────────────────────────────────────────┐
│ TempDir <path> │
└─────────────────────────────────────────────────────────────────────────────┘
The TempDir keyword defines a directory for DizMan's temporary files.
┌─────────────────────────────────────────────────────────────────────────────┐
│ DirList <filename> │
└─────────────────────────────────────────────────────────────────────────────┘
The DirList keyword defines a textfile which defines the directories and the
files DizMan should work on. If no DirList is defined you have to define a
workfile via commandline.
The DirList-file must have the following format:
<path>[<filename>] [@<filename>]
So these entry would be o.k. in the DirList-file:
D:\FILES
D:\FILES\
D:\FILES\*.*
D:\FILES\*.ARJ
D:\FILES @D:\LISTS\FILES.BBS
D:\FILES\ @D:\LISTS\FILES.BBS
D:\FILES\*.* @D:\LISTS\FILES.BBS
D:\FILES\*.ARJ @D:\LISTS\FILES.BBS
┌─────────────────────────────────────────────────────────────────────────────┐
│ LogFile <filename> │
└─────────────────────────────────────────────────────────────────────────────┘
The LogFile keyword defines a log-file for DIZMAN. If you want to establish
a LOG-FILE, you have to declare it! E.g.:
LogFile C:\DIZMAN\DIZMAN.LOG
┌─────────────────────────────────────────────────────────────────────────────┐
│ SwapFile <filename> │
└─────────────────────────────────────────────────────────────────────────────┘
The SwapFile keyword defines a swap-file that DIZMAN uses if it can not swap
into EMS.
SwapFile C:\DIZMAN\DIZMAN.$$$
┌─────────────────────────────────────────────────────────────────────────────┐
│ SaveFilesBbsExt <file-extension> │
└─────────────────────────────────────────────────────────────────────────────┘
SaveFilesBbsExt defines the extension of the files.bbs backup file. Default
extension is BAK
┌─────────────────────────────────────────────────────────────────────────────┐
│ ProcessLastDays <number> │
└─────────────────────────────────────────────────────────────────────────────┘
The ProcessLastDays keyword defines which files should be processed. If only
files younger than x days should be processed set ProcessLastDays to x. If
all files should be processed set 0. Default: 0. Range: 0-100.
┌─────────────────────────────────────────────────────────────────────────────┐
│ AddOrphan │
└─────────────────────────────────────────────────────────────────────────────┘
The AddOrphan keyword instructs DizMan to add to the FILES.BBS (or equiva-
lent) any file that was processed and was not listed in FILES.BBS already.
┌─────────────────────────────────────────────────────────────────────────────┐
│ OrphanDesc <string> │
└─────────────────────────────────────────────────────────────────────────────┘
The OrphanDesc keyword instructs DizMan to add a special description to the
FILES.BBS (or equivalent) for any file that was processed and was not listed
in FILES.BBS already.
┌─────────────────────────────────────────────────────────────────────────────┐
│ Ignore <filename> │
└─────────────────────────────────────────────────────────────────────────────┘
The Ignore keyword instructs DizMan to ignore all files with the specified
name. You are allowed up to 50 filename!
┌─────────────────────────────────────────────────────────────────────────────┐
│ DizName <filename> │
└─────────────────────────────────────────────────────────────────────────────┘
The DizName keyword defines filenames of FILE_ID.DIZ like files. You can
define up to 10 DizNames. No WildCards!
┌─────────────────────────────────────────────────────────────────────────────┐
│ CutDiz <number> │
└─────────────────────────────────────────────────────────────────────────────┘
The CutDiz keyword defines where to shorten the FILE_ID.DIZ. A value of x
will shorten the FILE_ID.DIZ to x letters on each line. If e.g. filedescrip-
tion starts with column 35, you should set CutDiz to 45.
Default: 45. Range: 0-255 (0 = No cut).
┌─────────────────────────────────────────────────────────────────────────────┐
│ NoLongDesc │
└─────────────────────────────────────────────────────────────────────────────┘
The NoLongDesc keyword is used if you want the description all in one line.
Please note: The automatic line-handling of the most bbs's may cause some
garbage then! Default: off
┌─────────────────────────────────────────────────────────────────────────────┐
│ BeginLongDesc <number> │
└─────────────────────────────────────────────────────────────────────────────┘
The BeginLongDesc keyword is used if the long file-description should begin
at a special column. Default: 1. Range: 1-255.
┌─────────────────────────────────────────────────────────────────────────────┐
│ LongDescStartStr <string> │
└─────────────────────────────────────────────────────────────────────────────┘
If you want a special sign on each line of a long description you can use the
LongDescStartStr keyword. Default: No StartStr
┌─────────────────────────────────────────────────────────────────────────────┐
│ KillHiAscii │
└─────────────────────────────────────────────────────────────────────────────┘
The KillHiAscii keyword instructs DIZMAN to replace all HiAscii's ( > 127) in
the FILE_ID.DIZ with Blanks (Ascii 32). Default: off.
┌─────────────────────────────────────────────────────────────────────────────┐
│ KillMultiBlanks │
└─────────────────────────────────────────────────────────────────────────────┘
If KillHiAscii and NoLongDesc is on, it KillMultiBlanks should be on! If it
is on all 'long spaces' (a string of ASCII #32) in the description will be
converted to a 'short space' (only one ASCII #32). This does only work if the
NoLongDesc is on! Default: Off.
┌─────────────────────────────────────────────────────────────────────────────┐
│ MaxDizLines <number> │
└─────────────────────────────────────────────────────────────────────────────┘
The MaxDizLines keyword tells DIZMAN how many lines of the FILE_ID.DIZ file
it should use for its Descriptions. Range: 0-255. Default: 255.
┌─────────────────────────────────────────────────────────────────────────────┐
│ SaveFirstDescLine │
└─────────────────────────────────────────────────────────────────────────────┘
SaveFirstDescLine tells DIZMAN to adopt the first of the old description for
the new description. This works only if NoLongDesc is off! It works only if
DIZMAN imports a FILE_ID.DIZ description! Default: off.
┌─────────────────────────────────────────────────────────────────────────────┐
│ ShowDlTime <string> │
└─────────────────────────────────────────────────────────────────────────────┘
With ShowDlTime you can instruct DIZMAN to insert a line with the DL duration
for some baudrates. You can use the following tags:
%bx - to define the baudrate (x = baudrate)
%h - force display of hours
%m - force display of minutes
%s - force display of seconds
Example: ShowDlTime %b2400bps %h:%m:%s * %b14400bps %h:%m:%s
Would insert a line like this:
2400bps 00:17:29 * 14400bps 00:02:54
By default DIZMAN will not show a DL time-info! ShowDlTime works only if the
NoLongDesc keyword is not set.
┌─────────────────────────────────────────────────────────────────────────────┐
│ CounterStyle <char><char> │
└─────────────────────────────────────────────────────────────────────────────┘
The CounterStyle keyword specifies which counter delimiter to use. Default []
┌─────────────────────────────────────────────────────────────────────────────┐
│ CounterLength <number> │
└─────────────────────────────────────────────────────────────────────────────┘
The CounterLength keyword tells DizMan how many digits to use in the counter.
If you specify 4, then there will be 4 characters between the delimiters.
Numbers will NOT be zero padded however, they will be space padded on the
left, ie. [ 1]. Default: 0. Range: 0-10 (0 = No counters).
┌─────────────────────────────────────────────────────────────────────────────┐
│ SpaceForZero │
└─────────────────────────────────────────────────────────────────────────────┘
The SpaceForZero keyword instructs DizMan to use a space for a zero count
instead of a zero. That is, DizMan will insert a [ ] instead of a [ 0].
The default is to use a zero instead of a space.
┌─────────────────────────────────────────────────────────────────────────────┐
│ ZeroPadded │
└─────────────────────────────────────────────────────────────────────────────┘
The ZeroPadded keyword instructs DizMan to padd counters with zeros instead
of spaces, ie. [0001] instead of [ 1]. This is in effect when adding new
counters. The default is to pad with spaces.
┌─────────────────────────────────────────────────────────────────────────────┐
│ End Settings │
└─────────────────────────────────────────────────────────────────────────────┘
Closes a SETTINGS frame.
┌─────────────────────────────────────────────────────────────────────────────┐
│ Archive │
└─────────────────────────────────────────────────────────────────────────────┘
Starts a ARCHIVE frame. You can define up to 50 archives! With the ident-code
DizMan will check ALL archives in the same order as they are defined. So be
careful: Do not change the order of ARC/PAK/HYP with the default ident codes!
┌─────────────────────────────────────────────────────────────────────────────┐
│ ArcName <packername> │
└─────────────────────────────────────────────────────────────────────────────┘
The ARCNAME keyword tells DizMan the name of the Archiver
┌─────────────────────────────────────────────────────────────────────────────┐
│ Ident <offset>,<hex-string> │
└─────────────────────────────────────────────────────────────────────────────┘
Unless you are familiar with the internals of compression programs, the IDENT
keyword (see below) should not be modified. Two numbers follow the keyword,
each separated by a comma. When attempting to decompress an archive of an
unknown type, DizMan will use this information to automatically identify
different types of archives.
The first number after IDENT contains the OFFSET at which a special identify-
ing marker can be located. Positive entries work in the expected manner,
whereas negative entries can be used to indicate offsets from the END of a
compressed file. However, an offset of "-1" is the LAST character, and an
offset of "-2" the SECOND-LAST character, etc.
Following the OFFSET is a series of hexadecimal numbers which represent the
text which can be found at the specified offset in the compressed file. Each
byte in the compressed file should be represented by the appropriate hexade-
cimal character. For example, an uppercase 'A' can be represented with a '41'
which is the ASCII code for 'A' (in hexadecimal). Strings of characters may
also be recognized by simply specifying more than one sequence of bytes.
┌─────────────────────────────────────────────────────────────────────────────┐
│ Command <commandline> │
└─────────────────────────────────────────────────────────────────────────────┘
The COMMAND keyword tells DizMan how to unpack compressed files of the speci-
fied type. "%a" will be translated to the name of the archive, and "%f" will
be translated to the name of the file to extract.
A '*' as first char after COMMAND indicates that the COMMAND keyword is used
as a description style definition. You can use the following tags in the
COMMAND definition:
│
%bx = patches the byte value at offset 'x' in the current workfile
into the description.
%d = description found in files.bbs
%e+a,b = will be replaced by the result of 'a + b'
%e-a,b = will be replaced by the result of 'a - b'
%e*a,b = will be replaced by the result of 'a * b'
%e/a,b = will be replaced by the result of 'a DIV b'
%e&a,b = will be replaced by the result of 'a AND b'
%e<a,b = will be replaced by the result of 'a SHL b'
%e>a,b = will be replaced by the result of 'a SHR b'
%fa = searches in the archive for string 'a' and will be replaced
by the offset of the first a found in the archive. 'a' must
be a hex-string!
%sx,y = patches a string with a length of y characters starting from
the offset 'x' in the current workfile into the description.
%wlhx = patches the word value at offset 'x' in the current workfile
into the description. (lower byte first!)
%whlx = patches the word value at offset 'x' in the current workfile
into the description. (lower byte last!)
Note: The difference between %whl and %wlh is the following: If a file starts
with a hex-string of '12 34 D4 FF ...' the tag %wlh0 would translate 3412h to
'13330' and %whl0 would translate 1234h to '4660'.
┌─────────────────────────────────────────────────────────────────────────────┐
│ End Archive │
└─────────────────────────────────────────────────────────────────────────────┘
Closes a ARCHIVE frame.
╔═════════════════════════════════════════════════════════════════════════════╗
║ Running DizMan ║
╚═════════════════════════════════════════════════════════════════════════════╝
Syntax:
DIZMAN.EXE <filename> [options]
Currently DizMan knows the following options:
/? Request commandline help.
/C<filename> Which configfile to use. DIZMAN.CFG is default.
/F<filename> Which file to use as a FILES.BBS.
Examples:
DIZMAN.EXE *.*
DIZMAN.EXE TEST.A?? /CC:\BBS\DIZMAN\DIZMAN.CFG
DIZMAN.EXE F:\MSDOS\*.* /FC:\CD1\MSDOS.BBS
╔═════════════════════════════════════════════════════════════════════════════╗
║ Revision History ║
╚═════════════════════════════════════════════════════════════════════════════╝
1.20 - New: Enhanced all 'special commands' and added the %e
and the %f tag.
New: Added support for PCX and JPG without HSI header.
New: Now DizMan can also insert the 'number of colours'
for all graphic-formats (except SCX - I don't now where
to get the colour-information ;-)
1.11 - New: Converted the 'special command' tag %w to %wlh and
added the %whl tag.
New: Added BMP/JPG/LBM/MAC/MSP/PIC/RLE/SCX support.
1.10 - New: DizMan has a new outfit. Now you can see what ex-
ternal programs like ARJ etc do.
New: Now DizMan calls external programs directly. There
is now more memory for the external programs because
COMMAND.COM is no longer loaded.
New: Now DizMan can swap to EMS/Disk to give the exter-
nal programs a maximum of space ( DizMan will only use
about 30K)! See also SWAPFILE.
New: DizMan now recognizes 8 new formats (S3M, ARJ SFX,
LHA SFX, PAK SFX, ZIP SFX).
New: Added the KillMultiBlanks keyword for better sup-
port of singleline descriptions (NoLongDesc).
BugFix: Now DizMan inserts a blank (#32) at the end of
a FILE_ID.DIZ line if you use NoLongDesc.
1.01 - Modified the sample configuration and added support of
the HA and HAP&PAH packer.
- New: Added a german documentation to the distribution
archiv.
- New: Added the LogFile keyword to define a logfile.
- New: Added the DirList support.
- New: If KillHiAscii is on Ä, Ö, Ü, ä, ö, ü, ß will be
translated to Ae, Oe, Ue, ae, oe, ue, ss!
- BugFix: If SaveFirstDescLine was set and DizMan found a
FILE_ID.DIZ with an empty first line the old descrip-
tion was lost in space.
- BugFix: If SaveFirstDescLine and KillHiAscii was set
and the old description was the same as the first non-
empty FILE_ID.DIZ line (after HiAscii's were killed)
the description line was doubled.
- BugFix: If DizMan was aborted by an error it sometimes
did not reset the directory to the startup directory.
- BugFix: Fixed some sharing-problems.
- BugFix: If a file was listed in the FILES.BBS and there
was an empty line after the description, the empty line
disapeared after inserting a FILE_ID.DIZ comment.
- Some smaller internal changes.
1.00 - Base version. (Turbo Pascal 6.0)
╔═════════════════════════════════════════════════════════════════════════════╗
║ Thanks ║
╚═════════════════════════════════════════════════════════════════════════════╝
Thanks to:
- Johan Zwiekhorst for the excellent GUS (General Unpack Shell)
Documentation!
- Martin Austermeier for his ideas in the DOSWIN module.
- Kim Kokkonen for his article in Dr. Dobbs Journal 4/1988.
- Anders Danielsson for his Repack program.
- Thomas Mainka for the ADIR documentation.
╔═════════════════════════════════════════════════════════════════════════════╗
║ Documentation for DizMan v1.20, written 1993 by Stefan Kuhn. ║
╚═════════════════════════════════════════════════════════════════════════════╝
